home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Enigma Amiga CD / Tools / DMSII.Doc < prev    next >
Text File  |  1992-12-21  |  15KB  |  413 lines
  1.  
  2.            Welcome to the DMS Intuition Interface V1.0 User Manual.
  3.            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  4.  
  5.         The release date for this marvellous pile of junk is 17/7-93.
  6.  
  7.  
  8.                                 The contents:
  9.  
  10.                       1. Disclaimer and Distribution
  11.                       2. Copyright Notices
  12.                       3. Introduction
  13.                       4. Requirements
  14.  
  15.                       5. Starting DMSII
  16.                       6. Setting the Preferences
  17.                       7. How to use DMSII
  18.  
  19.                       8. Known bugs / bug suggestions
  20.                       9. History
  21.                      10. Final Notes
  22.  
  23.  
  24.  
  25.                         1. DISCLAIMER AND DISTIBRUTION
  26.                         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  27.  
  28.  
  29.                          DMS Intuition Interface V1.0
  30.                          Copyright © 1993 by Newtec.
  31.  
  32.                                  DISCLAIMER!
  33.                 READ THIS BEFORE YOU START USING THE PROGRAM!
  34.  
  35.  
  36.  The author cannot be held liable for the suitability or  accuracy  of this
  37.  manual  and/or  the  program(s)  it  describes.  Any  damage  directly  or
  38.  indirectly caused by the use or misuse of this manual  and/or the  program
  39.  it describes is the sole responsibility of the user her/him self.
  40.  
  41.  DMS Intuition Interface, © Copyright 1993 by Newtec.  All rights reserved.
  42.  This program is FREEWARE which means  that  you  can  use  it for free and
  43.  copy it to whoever you want, as long as you don't charge any money for it,
  44.  other than the price of disks, stamps etc.
  45.  
  46.  This program may *not* be uploaded on BBS's that  claim copyrights  on the
  47.  uploaded material.
  48.  
  49.  Commercial  distribution of  DMS Intuition Interface  and/or it's relative
  50.  files  is  *NOT*  allowed  without  written  permission  from  the author.
  51.  This also means the distribution on cover disks, disk magazines etc.
  52.  
  53.  The binary  output  of this program  do not fall under the above mentioned
  54.  rules.  They  fall  under the rules that  the person(s)  who created these
  55.  files.
  56.  
  57.  Updates are  *not*  available through me. For updates you are dependand on
  58.  me releasing newer versions.
  59.  
  60.  If you have any suggestions  or bug reports,  please send them to me,  and
  61.  I'll  try  to solve  your  problem.  A section  about known  bugs and  bug
  62.  reporting is comming up later !
  63.  
  64.  
  65.  
  66.  
  67.                              2. COPYRIGHT NOTICES
  68.                              ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  69.  
  70.  
  71.                          DMS Intuition Interface V1.0
  72.                          Copyright © 1993 by Newtec.
  73.  
  74.             Written on an A1200 with 2 mb chipmem, 85mb harddrive
  75.        using AsmOne V1.16 made by Rune Gram Madsen, and updated by TFA.
  76.  
  77.        Ideas taken from DMS-Window V2.30, Copyright 1992 by Colin Bell
  78.  
  79.         DMSII makes use of the great Reqtools.library (OS2.0 version),
  80.              This library is copyright 1991-93 by Nico François.
  81.  
  82.              ASL.library, which can be used instead of Reqtools,
  83.                      is copyright by Commodore-Amiga inc.
  84.  
  85.                   DMS is Copyright 1989-91 by SDS Software.
  86.  
  87.  OWS, which optionally can be used is Copyright 1993 by Creative Productions.
  88.  
  89.     FdChk, which optionally can be used for testing is done by SiNTAX/WøT.
  90.  
  91.           The window design were made using GadToolsBox release 2.0
  92.                        copyrighted by Jaba Development.
  93.  
  94.  
  95.  
  96.                                3. INTRODUCTION
  97.                                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  98.  
  99.  
  100. DMS Intuition Interface is a handy utility which gives you 100% control
  101. over DMS, without even touching the keyboard. Everything is built op with
  102. gadgets and menus.
  103. There are other utilities to do this, however. Most of them are full of
  104. bugs, however. The DMS-Window V2.30 (Copyright 1992 by Colin Bell), crashes
  105. all the time on my A1200... This is why I decided to make this program.
  106.  
  107. DMS Intuition Interface is thoughfully tested, and it appears to work perfect.
  108. If it fails however, please don't kill me. Before doing anything, you
  109. better read the @{ "Disclaimer" link disclaimer} !!!
  110.  
  111. Features:
  112.     -:  Gives you 100% control of DMS.
  113.     -:  Everything is gadget- and menudriven, so you don't have to think of
  114.         all those long and boring Shell-arguments.
  115.     -:  Compatible with kickstart 2.0, 2.1, 3.0, 3.1, 4.0  (soft/hard) etc...
  116.         (Please read the section about known @{ "bugs!" link bugs})
  117.     -:  Compatible with 68000, 68010, 68020, 68030, 68EC030, 68040, w/FPU etc...
  118.     -:  Compatible with A500(+), A600, A1000, A1200, A2000, A3000, A4000  etc...
  119.     -:  etc. etc. etc........
  120.  
  121. Luxories:
  122.     -:  100% multitasking! You can extract different files to upto 90 drives
  123.         at the same time!!!!!!
  124.     -:  Option to select an alternate archiver, compatible with DMS.
  125.         This way, you can turn this program into an OWS-Window!
  126.     -:  Ability to use an alternate DMS-Tester (eg. the much faster FdChk).
  127.     -:  Working on many different Workbench screen modes and resolutions
  128.     -:  Supports Reqtools- AND ASL.library for the filerequesters!
  129.     -:  Options for Formatting, Singledrive Diskcopying, Deleting, ...
  130.     -:  etc. etc. etc........
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                4. REQUIREMENTS
  137.                                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  138.  
  139.  
  140.  DMS Intuition Interface  was programmed using the Asmone V1.16 (By TFA) on
  141.  an  Amiga 1200, w/kickstart V39.106,  Workbench  V39.29  with 2 MB  memory
  142.  (2 chip, 0 fast), AGA chipset, 14mhz 68020, 85 MB IDE harddisk.
  143.  
  144.  It is  also tested  on an  Amiga 500 with an A530 turbo harddisk (240 MB),
  145.  40 mhz 68030 processor and 68882 coprocessor, 5 MB memory (1 MB Chip, 0 MB
  146.  Fakefast,  4 MB  Realfast),  Kickstart  40.3 ßeta and  Workbench 40.4 ßeta
  147.  (software version).
  148.  
  149.  It should run perfectly on all Amigas (except for those old, stinky, ugly,
  150.  fucking etc. 1.2/1.3 Amigas  8), independent of processor speeds, chipsets
  151.  etc.  If you don't have a harddisk,  and only one diskdrive, I don't think
  152.  that you'll get much out of this program, however...
  153.  
  154.  If you have a Kick 1.2/1.3 Amiga,  and you want a working version for Your
  155.  computer, well BAD LUCK then!.. I don't really feel like using the megaold
  156.  PowerWindows  shit to  create Kick1.3  menu/gadget designs etc. that makes
  157.  the final program take up 3 times the space of the 2.0 version!.
  158.  But if you really, REALLY, ® E /\ |_ |_ ¥  need it, you'd better send me a
  159.  letter containing something to convince me. (A gift? yeah!)
  160.  ... Oh by the way,  I am currently in need of an A4000 060/66+, 9GB+ hard-
  161.  disk, 19.2K baud Modem, tapestreamer, etc... 8)
  162.  
  163.  
  164.  Check that you have the following:
  165.  
  166.  kickstart                  version 37 or higher (soft or hardware)
  167.  workbench                  any version
  168.  reqtools.library           any version
  169.  DMS                        version 1.11
  170.  NewShell                   any version
  171.  Delete                     any version
  172.  Sys:System/Format          any version (optional)
  173.  FdChk or other DMS-Testers any version (optional)
  174.  Multiview or AmigaGuide    any version (optional)
  175.  
  176.  (Please read the section about known bugs!)
  177.  
  178.  
  179.  
  180.  
  181.                            5. Starting the program
  182.                            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  183.  
  184.  
  185.  You can run DMS Intuition Interface from either the Shell or from the
  186.  Workbench. To start from the Shell, you just type the following:
  187.  
  188.     DMSII
  189.  
  190.  If you write any arguments, they'll just be ignored.
  191.  
  192.  After  a  successfull  start  you  are presented  with a little window
  193.  on the workbench. This window is the main window.
  194.  
  195.  
  196.  
  197.  
  198.                           6. Setting the Preferences
  199.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  200.  
  201.  
  202.  Setting the Preferences are very simple. Just set the checkmarks the way
  203.  you like in the Preferences menu.
  204.  
  205.  
  206.  Complete run-through of the Preferences Menu:
  207.  
  208.  -: Load Preferences
  209.  
  210.     If you made changes to the prefs that you regret, just select this option,
  211.     and they will be reloaded.
  212.  
  213.  -: Save Preferences
  214.  
  215.     Save the current settings, so you won't have to set them again next time
  216.     you load DMSII.
  217.  
  218.  -: Save Preferences When Quit?
  219.  
  220.     Set this menuflag if you want the preferences automatically saved when
  221.     you quit DMSII.
  222.  
  223.  -: Change DMSPath
  224.  
  225.     Use this to specify where your DMS executable is. This function might be
  226.     necessary for you to use, if it isn't in C:DMS on your harddisk.
  227.     If you select OWS instead of DMS here, you'll get a complete OWS-Window
  228.     tool with most of OWS' functions supported! Might be usefull too...
  229.  
  230.  -: Close Windows Immediately?
  231.  
  232.     If this menuflag is set, the DMS output window (opens when you press the
  233.     'START' button) will close immediately when DMS returns. Else it will wait
  234.     for you to press the Return key or the windows Close gadget.
  235.  
  236.  -: Use DMS for testing?
  237.  
  238.     If this menuflag is set, DMS will be used for testing. (And if you have
  239.     selected OWS in the DMSPath menu, OWS will be used for testing instead).
  240.  
  241.  -: Use other tester?
  242.  
  243.     If this menuflag is set, the tester specified in 'Select other tester'
  244.     (see below) will be used.
  245.  
  246.  -: Select other tester
  247.  
  248.     When you select this menu, you'll be prompted to specify which tester you
  249.     want to use instead of DMS. This allows you to select the FdChk tester
  250.     (by SiNTAX/WøT), which is much faster and better than DMS.
  251.     NOTE: The tester MUST take the DMSFilename as the first argument. For
  252.     example, if you selected the C:FdChk tester and the file MyFile.DMS,
  253.     DMSII will try to execute the following: C:FdChk MyFile.DMS
  254.  
  255.  -: Use Reqtools.library?
  256.  
  257.     Use the Reqtools.library for the filerequesters rather than Commodore's
  258.     ASL.library. Most people prefer Reqtools, because it's faster and easier
  259.     to use. Therefore, this menu is selected as default.
  260.  
  261.  -: Use ASL.library?
  262.  
  263.     If you prefer ASL.library instead of Reqtools, select this function.
  264.     NOTE that even if you select ASL.library, Reqtools will still be loaded
  265.     and used for the Text Requesters since the ASL.lib. doesn't supply any of
  266.     these functions. I Could change this... Maybe in the next version!..
  267.  
  268.  -: Show file information?
  269.  
  270.     Show the selected archive and it's size in the Screen's title bar. This
  271.     feature can be used to find out quickly if the filename you entered really
  272.     exists, instead of starting DMS.
  273.     There are a small disadvantage of having this feature on, however. DMSII
  274.     will reload the filename info now and then, which can be quite annoying if
  275.     you selected a file on a disk.
  276.  
  277.  
  278.  
  279.  
  280.                                7. How to use...
  281.                                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  282.  
  283.  
  284.  DMSII is really easy to use. Just try everything...  Anyway, here's an
  285.  example:
  286.  
  287.  
  288.  The normal procedure for extracting a DMSfile to DF0: is the following:
  289.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  290.  
  291. o First, select the 'Write to Disk' gadget.
  292.  
  293. o Press the 'Get' gadget and select a DMS file, or enter it's name in the
  294.   Archive Name string gadget.
  295.  
  296. o Select the DF0: drive gadget.
  297.  
  298. o If you don't want to see all those BBS advertisments all the time, make sure
  299.   the 'Show Text' gadget is off.
  300.  
  301. o You can set other details if you wish, but normally it's unnecessary.
  302.  
  303. o Press the 'Start' gadget, and here goes...
  304.  
  305. o If you wish to extract an other DMS file to DF1, for example, you don't have
  306.   to wait for DF0: to be finished. Just get the DMSII window to front, and
  307.   it's ready to use...
  308.  
  309.  
  310. ...That wasn't hard, was it?
  311.  
  312.  
  313.  
  314.                            8. Bugs and Suggestions
  315.                            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  316.  
  317. Known Bugs:
  318. ¯¯¯¯¯¯¯¯¯¯¯
  319.  
  320. Currently, the program doesn't work at all on kick 2.0! Shit.. I couldn't test
  321. it out myself, because I have the kick 3.0 ROM, and not enough memory to
  322. softkick anything..
  323. I think I know what's wrong. What I don't know, however, is how to correct the
  324. bug... The problem (this is getting technical!) is that I use the
  325. Gadtools/GetGadgetAttrs function to read the gadget status.. This function
  326. only work on kick 3.0+. I don't know any other ways to do this, so I'm pretty
  327. stuck... HELP!
  328.  
  329. Other bugs:
  330. ¯¯¯¯¯¯¯¯¯¯¯
  331.  
  332. If you find any other bugs in this program, PLEASE tell me. Tell me exactly what
  333. you did, what computer you use and everything else which matters.
  334.  
  335. (Don't tell me that the implementation of ASL is lousy, I know it.. Beg me to
  336. improve it!)
  337.  
  338.  
  339. Send send suggests, bugs and everything you like (money! yeah! yeah!) to:
  340.  le  chef    Lars Hansen
  341.    \  /      ~    ~
  342.   _ /\ _     Sivsangervej 7
  343.     \/       9800 Hjoerring
  344.    /  \      Denmark
  345. god himself  (+45)98910663
  346.  
  347.  
  348.  
  349.                                   9. History
  350.                                   ¯¯¯¯¯¯¯¯¯¯
  351.  
  352.  
  353. History of this legendary program:
  354.  
  355. V1.00 (17/07-93):  First Release! Let's throw a party!
  356.  
  357.  
  358.  
  359.  
  360.                                10. Final Notes
  361.                                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  362.  
  363.  At this time there really isn't much to say about the program.    It is a
  364.  tool that will (or at least should)  save you a  lot of time  and trouble
  365.  working with DMS-Files.
  366.  
  367.  When a big font is used in the program it can happen that some requesters
  368.  won't fit on the screen anymore. Intuition will automatically re-size the
  369.  requester so that it will fit on the screen but some gadgets might not be
  370.  reachable anymore.
  371.  
  372.  If   someone   wants  to  translate this  manual  into  her/his  language
  373.  permission is hereby granted.  The only thing I ask is that you send me a
  374.  copy of  the translation  so that  I can  distribute  it with  the   next
  375.  release of  the program.
  376.  
  377.  When  submitting a bug-report,  please  tell me the  version  of the  DMS
  378.  Intuition  Interface  program you  are using.  You can find out by typing
  379.  "Version DMSII" from a shell/cli,  or just load the program,  you can see
  380.  the version number in the titlebar.
  381.  
  382.  Bug reports, suggestions, postcards,  flames,  criticism,  contributions,
  383.  ideas, gifts etc.. to:
  384.  
  385.  le  chef    Lars Hansen
  386.    \  /      ~    ~
  387.   _ /\ _     Sivsangervej 7
  388.     \/       9800 Hjoerring
  389.    /  \      Denmark
  390. god himself  (+45)98910663
  391.  
  392.  
  393.  
  394.     »» "Trust me. I know what I'm doing."          -: Sledge Hammer  ««
  395.  
  396.     »» "Life sucks."                               -: Al Bundy       ««
  397.  
  398.     »» "Hasta la vista, Baby."                     -: The Terminator ««
  399.  
  400.     »» "Make noise, Tell the world to fuck off!"   -: Bono           ««
  401.  
  402.     »» "The most mercifull thing in the  world, I"
  403.        "think, is the inability of the human mind"
  404.        "to correlate all it's contents.          " -: Propaganda     ««
  405.  
  406.     »» "Normal is boring."                         -: Fido Dido      ««
  407.  
  408. (These nize sentences was stolen from the Gadtoolsbox docs, couldn't think of
  409. any myself..)
  410.  
  411.  
  412. [EOF]
  413.